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1301 



TOTAL JttTfcS 


MUMBKR 


For lixport estimated sfre of data in job. 
For Import ut/eofditii in job to be tai&d. 


PLATFORM 


VARCHAR2(!0Q> 


plat fa rro used for the 1« xnort/linpo n 


ENHANCE 


VARCIIAK2(I5) 


Instance name that job is runnings upon (RAC only) 


ABORT JSTFP 


SiUMBKR 


Processjeroer number u f Object iw diat wil cause the job to 
;\hm, For testing, parposex only. 


KCN 


MUMBIiR 


The Syslan Change Number passed to logical Standby foraH 
POL creation*. This it *m* lire SCN used for TABLE 
DATA OHJ ECT rows; they each have their own . | 


0BJIeCT_TVW2_PATH 


VARaiAJU|200> 


Final tennhulion ims«ti^c for job 


01. 1) VALUF 


VARrilAR3k«)Q0l 


Tb»* is ite opaque "coolst*?** rcttwwd kmw by dhrnt* internal 
jwile senavedl sen daring; export and banded in during onport 
& network. Used hy I ogtcji Standby 'Strtums 


FLAGS 


S'MMBHR 


XOtJOOOOO 1 Job is interesting for either streams or logical 
standby and the StNs for tables need lo be spiled via the 



state row 1205B (517) 



Column Name 


ftMitypc 


Meaning 


PROCI&SORD13R 


NUMHFR 


^ for Export jebs. 


DUPLICATE 


NUMBER 






NUMBER 


Highest value of PROCESS OROKR in Mister Table, 
Originally set Iq i when Master Table is inalally created 



MAX_PROCESS_ORDER row 1303 (517) 



Column Name 


IXitalype 


Meaning 


PROCESS JORMR 


NUMBER 


•$ fm lixpm jens. 

^ for Import ural SQL Fitejqt*. 


DUPLICATE 


NUMBER 


The sequence ninnber for each abject type 


OBJI3CT.TYPK.HATII 


VARCHAR2(20O) 


Path of object type whose processing has completed 


OBJECT PATH SliQNC) 


NUMBER 


Seduce numbet for object type. TO* field orders object 
types Ibr import. 


COMIM>:ilON_TlMh 


DA Hi 


Time when processing of object was completed 


TOMFLCTRD ROWS 


NUMBER 


The mimberot' objects of current object rviih have been pro- 
cessed 



TYPE_COMPLETION row 1305 
(517) 



Flo. 13 
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Column Name 


Datatype 


Meaning 


503 


PROCI*SS_ORDKR 


VUMBFR 


•21 for l£x.puii jobs. 

■22 for Import and SQL Kile j^bs. 


504 


DUPLICATE 


VUMBKR 


Interned number assigned to each 111* as it is specified sii export 
tttne. Tile reference* by OWI&T raw* atouys usethknuniber 
miner ttun the fil c nunc. 


1403 


FiLEjnrns 




O if disk file. 


r 


USBftJJflUCTORY 


VARCH,VR2(40CX» 


Directory pu£hu*ed fbr tiiotpftlc. 




uskr HUH KAMI- 


VARCtlAR2l(4QQO) 


Origin**! file turns! spec i fed by «?«r ! 




FIIJi^NAME 


VAUCH \R2{40CO) 


Fidly re-solved name t including path information* for file. 


1407 




MUMIIKR 


Maximum sire lor the flte. D if (He is extendable. 



FILE row 1401 (521) 





Column Name 


Datatype 


Meaning 


503 


PROCESS ORDER 


VUMBI-K 


>2&for Import jobs. 

-24 for Import and SQL _Ffle jobs. 


504 


DUPLiCATfe 


SfUMBKR 


Ordinal position for when litis ADDJ-ILli was sped lied (used 
l» nuiimain n>tmd r»b5n v»f\Jcrinjr between wildeanted rymes). 


1411 


FUJI .NAME 


VARCHAR2t4QQ0) 


fempbUe for filename including substitution variables. 


1413 


*llJLMAX_SIZ|i 


VUMBKR 


ktiximam size fur the lite. 0 iffiJc is extendable. 


1415 


SKI!!) 


number 


Last vMts used for reviving sjsteifttatan variable*. Haeli 
wildcard spceificatran needs a tin ique number sinee ADD 
FILlis can eutiw lit alter the job has glutei! 


1417 


LAST FILE 


VUMBIiR 


Rle number of last file resolved from (Mi* wildcard siring. This 
eel urn t* b used to identify where we are in ibe round roNn 
?xpanm*» of wildean&d romes. 



WILDCARD FILE row 1409 (521) 



Fig. 14 
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503 

504 
1503_ 



1505 



1507 -< 



1509 V 



f \iltimn Vamp 


1 Vital vnt> 


Meaning 


HKtR. liS> UKIJhK 


Ml I* 113 U EJ> 

iNUMIJhK 


-4 1 for I-Jiport Jobs. 

-42 for Import and SQLJ*ih* jobs^ 


DUPLICATE 


PUMIIKR 


Internal Ul for the worker precox. 


P ROCKS S NAME 


VARCHAR3(30) 


Process runic for the worker process 


DBJECT_NUMBHR 


NUMI3ER 


PR€XTiSS_ORI>ER value for the object tving processed by th« 
worker pwwxsj*, 


OBJECT .SCHEMA 


VARCTIAR2C30) 


ITjc scheiru of the object being processed, Nidi if not in 
IvXKCUTING m*\c or pnjcessin&a nttn-seheraa object . 


QmnCT NAME 


VARCHAR2C509) 


The naiiv of in* object ivirt? proccsiedL Nut! if nol m 
CUTING stole or processing an unnamed oh jeel. 


OBJECT _ LONG_NAMIi 


VARCHAR2(4$GO) 


ttte earne of thtt object tvin^ processed Null tfiiut &t liXE* 
CUTING stale or processing an ui Burnt**! objeel- 


OBJECTjrYPRJ»ATH 


VAR€HAR2(2$0) 


The object lyjx! nathnamc of the object bring processed. Null if 

m in liXHCirriNO anao. 


PARTITION NAME 


l r ARCH A R 2(50) 


The name of the parti I ton of the object tving processed Only 






abject wtditn a partitkrtied table: Null otherwise. 


TOTAL HYTRS 


NUVUiFR 


NiiiBber ofhytes within a TABLE DATA object, On 
liXPOK!\ number may a estimate. NULL if no estimate is 
available on ofejeci or if w\»ik is t*ot processing a *f A HI J* 
DATA object. 


COMPLETED rows 


NUMBER 


Number of diiei row* wiittca or read for current TAIILE 
DATA object. For other objects, the lunmber of objects of 
cunvnl obfcei p^un have been prvKcs^dL 


LASTUPDATE 


PATE 


Time offcast u palate for Worker row. Used to approximate die 
litrie of a crush dnri itg restm. 


WORK ITliM 


VARCHAJUtHQ) 


Current work icew bejn& proeewod by Worker, NOLL if 
worker is idle. Possible vaEwes are UNLOAD METADATA. 
UNLOAD DATA, LOAD MIiTAlMTA. LOAD DATA, 
ESTIMATE JOH, SQL FILE JOB, RELEASI* KI LES. and 

ivxniNc; 


STATE 


VARCHAR2(J0) 


One of lltas following values: WORK WAITING. FILE 
WAITING. I3CECUTINO. MASTER. 

WQRK W W A ITING - worker is wailing for work from the 
MaMer Control Process. 

RIJK_ WAITING " worker is wading for a tile spuee from the 
Master Control Process. 

EXECUTING - worker is processing one or more creels. See 
OBJECT NifMHI2R«idORJI'Cr ROWIDwIuroiw for 

Lit- lull Jfc, 

MASTER - Worker Process is eiltocr saving or restoring the 

K*t"i?vl£*r f uMn tw> v livttt* lht> itntnn ttf** 


METADATA JO 


NUMBER 


Arttoant of Metadata written to th? dump 11 le( for export) or 
ivud from the dienp file (for Intpott) or imml^rrcd over the link 
since last restart for this Worker. 


DAI' A tO 


NUMBER 


Araotint of table data written to tliedunip fUeifor Fxport)ot 
reu%l from the dump file ( for Import) or transferred over the link 
since last restart for ties Worker. 


CUMULATIVE TIME 


NUMBER 


Tbc amount of lime ttui Ihfe worker f>rocv^.< Una spent uclhvly 
pa^ccssin^ t he job. 



WORKER TQW15Q1 (517) 



Fiq. 15 
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Column Name 


Oatalypr 


Meaning 


PROCESS ORDER 


NUMBUR 


■7 for Export jobs, 

-A for Import and SQL. Ft to jobs. 


DUPLICATE 


NUMBER 


3 


METADATA JO 


NUMBER 


Amount of Metadata written to the du mp flic (for export) or 
nea<I from the dump file (tor Import) or transferred over the link 
(for Import over h network). 


DATA 10 


NIJMIIHR 


Amount of I a ble data written to the dump fi to (for fa port) or 
nead morn the dUmp tile (for Import) or transferred ova tltc link 
Tor Import ovvr a network). 


TOTAL B Yl TvS 


NUMBER 


An estimate of lae tola! si/eof ttee job. For Import from lies, 
he total ii/c of the requeued data within the dump file. 


CUMULATIVE TIME 


MUMI1HR 


Sum of the ^mownt of rtm** limt cadi uvrlcer process tots spent 
actively processing toe job in hundredths of a second. It' 3 
worsens active for an hour, thb column would contain 



RESTART STATUS row 1601 



503 
504 


C olumn Name 


Datatype 


Meaning 


PROCESS ORDER 


NUMBER 


•9 fer Export job* \ 
• 10 for I mport jobs. 


DUPLICATE 


DUMBER 


Unique key assigned fc> each {reirtart of the job. The first Mart 
?fit j$b will rv roprenetiled by DUPLICATE 0. 


1606 

> 


MirTADATA ID 


NUMBER 


Byte* of Meirii.ru U wrtacn to <he dmnp tile (for csponj or raid 
from the iflump file (for Import) ur iraasfcfredover the link (for 
Network), 


DATA JO 


NUMBER 


Bytes of table dafci wrftlen to tlx* tniirip file I for Import) or read 
from Ihc ih»itp file (for Import) or iramfened over t&e link < for 
Network). 


total jiYTiis 


NUMBER 


Kor Import and ?C<J uork . an est i male of die total siiar of tke 
Operation (if available*. For rmport.theloUl size or flic 
vquscstoddlrtu wifliiti the dump Ilk*. 


i-RROR CO MKT 


NUMBER 


Number ofcrror* reported f*$rp?h 


CUMULATIVE TIME 


NUMBER 


Sum of the amount of lime taat each worker pnxess has .spent 
letively processing the? job. If i worker* wvre act tve fur an 
tour, ihii column would contain lOSOOOO. Usiae DATA IO. 
fOTAL BYTES. CUMULATIVE J'IME. artd K)B_ 
ST ATE. DEGREE, an estimate of the remaining time for trv jot 
ftill Ix? pcsssible. 




OBJECT TYPE PATH 


VARCIIAR2(200) 


final lerminiitioR memge from previonsjob aicnmaitou. 


ELAPSE»_TIME 


NUMBER 


Amount of lime that elapsed between the restart and Ihc laicst 
irneaainp found en the nc*i restart in IWjths of seconds 


START TIME 


pATI- 


fsLitrimg time for previous irttsmmtioii of job. 


PLATFORM 


V ARCH AR2f 100} 


Platform used cttaing previous incarnation of job. 


INSTANCE 


VARCIIAR2U5) 


Instance runic llui job incartigfioti ran upon (RAC ewly) 


DEGREE 


NUMBER 


IX'gioe of pttiiltolismai end of pnrvtou* itic^irrwiiortof job. 



RESTART row 1605 (51 9) 
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1703 



503 
504 

1705 
1707 



1711 



503 
504 

1713 



503 
504 



■< 



1719 
1721 

1723 



Colaroo Name 


Datatype 


Meaning 


PROCESSjORDER 


NUMI3HR 


-51 for forort Jobs. 

-52 for Import and SQI^frtlcjotw. 


ixnucAn? 


NUMBER 


Internal Ul for dfoliitgiitehii^ [Xiu* Filters 


NAME 


VARCBAK2(3©} 


Njitnc af filler. 


VALUE 1 


VARCHAR2(40QQ) 


IX* lira I ion of n text tiller. 


VALUR.N 


NUMB It R 


IX rmi tion of a nunierica 1 fillet 


OBJECT SCHEMA 


VARCBAIUiMM 


-Scfcemi of iabfc? !sj which filler apples 


OBJECT. NAMI: 


VARniAI«2(30J 


'lafelc families filter applies 


DATA FILTER row 170 


1 (523) 


Column Name 


Datatype 


Mealing 




NUMBER 


-53 tow lLxport job*. 

-54 for Impart and SQL J'ilejehs. 


DUPLICATE 


NUMBER 


Internal \ti fcrd&tingitbtiinjs Metadsta FiKirs 


NAM!« 


VARCHAR2<KM 


Name af filter, 


J VALUII.T 


VARaiAlt2(40O0j 


IX faation of til fcer 


OHJKCT_TYPH_WVTH 


VARCHAK2{200) 


Object class affected by die filler If NULL, the litter a fleets 
all otejtfci classes. 


METADATA FILTER rox 


V 1709 (523) 


Column Name 


Datatype 


Meaning 


PBOCKSS ORM*R 


NUMBER 


-57 for E&pon and hiliinate jobs 

-58 for Import. N^dwork and SQL_ Kite jobs. 


DUPLICATE 


NUMB BR j 


Interim] Id fhr (iiaAkigiifehirtg Metadata transfonm 


NAME 


VARnUI<2(K>) 


Name of Iternup or Transforni l.e^ul rumc b:$HC»MHNT 
attributes. 


OLD. VALUE 


VARCHAK2<4ftOD) 


Specific* value to be remapped tor remaps. NalJ olrtmvisc 


VALUH i 


VAROtAR2(4000]l 


Specific* new value far remaps, For trarolbnns. specifies the 


VALUU N 


NUMBER 


IXttniitouof a numeric ji llltcc 


QHJECV.TYPfi 


VARCHAICiJO) 


Object class a Heeled by flic remap or transform. It NULL, 
die remap or transform ulTeetsall applicable object c fcisscv 



METADATA TRANSFORM row 171 s (525) 
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503 
504 



Column \ame 


IXitalype 


Hearing 


PROCESS ORDER 


NUMBER 


-59 for Export johs. 

-6G for Import and SQL_Ftte jobs. 


DUPLICATE 


NUMHEK 


Interaal Ul fbrdim'niurisliuig Parameters 


NAME 


VARCHAK2(30) 


N«ne of PARAMETER. 


IS DEFAULT 


NUMHER 


If noiv/cro. parameter scuirt*? wns sol ttipplieci hy the client 


V'ALUJiJT 


VARCHAR2{4Ds8G) 


specifies the vitlit set for u text parameter. 


VV\LUL_N 


NUMOfiR 


IX'tuthfott iff a ruimerkjl parameter. 



PARAMETER row 1801 (527) 





Com mo Name 




Meaning 


503 


PROCI£S_pKDKR 


KUMBER 


tor l^xpiatt job*. 
►74 fot Import and! SQL File jo**. 


504 


UUPLICATK 


DUMBER 




1807 


VALUKT 


VARCHAR2C4COD) 


A DDL conirnand to reestablish the NlJs sellings for the job. 



NLS PARAMS row 1805 (527) 



Fig. 18 
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DECLARE 

handle NUMBER ; 



BEGIN 



1903 



1905 



1907 

1909 

1911 
1913 



handle : = DBMS_DATAPUMP . OPEN ( * EXPORT* , v FULL' , NULL, 

'MYDBMOVE^EXPORT' ) ; 
DBMS JPATAPUMP . ADD_FI DE ( handle , % f ilel .dmp' , 

% M¥_DIR1', *6G0M' } } 
DBMS_DATAPUMP.ADD_FILE (handle, *file2.dmp' , 

* MY_DIR2' , *6Q0M') ; 
DBMSJ5ATAPUMP . ADD_FI LE ( handle , * f i 1 e 3 . dmp' , 

' M¥_DIR3' , *€00H' ) ; 
DBM£_DATAPUMP . METADATA_FILTER (handle , * SCHBMA_BXPR ' , 

* lm ' 'BLAKE'") ; 
DBMS_DATAPUMP . SET^PARALLBL ( handle , 3) ; 
DBM £ JDATAPUMP . START^JOB f handle > ; 
DBMS DATAPUMP . DETACH (handle } ; 



1901 



DECLARE 

handle NUMBER ; 

BEGIN 

1917 handle : = DBHS_DATA PUMP .ATTACH i *MYDBM0VE_EXPORT* ) ; 
1919 DE*tS_DATAPUMP.STOP_ JOB (handle, 1, 1, 0); 
END; 

1915 



DECLARE 

handle NUMBER; 

BECIN 

192 3 handle := DBMS^DATAPUHP. ATTACH ( % MYDBM0 VE_EXPORT ' ) ; 
r~ DBMSJDATAPUWP . ADD_FILE (handle, * file4 .dmp' , 
> 5 J *MYJ)IR4 ' , 1 6O0M' ) ; 

| DBM£_DATAPUMP .ADD_PILE (handle, *£lle5. drop' , 
V W_DIR5' , % SO0M' ) ; 

1 927 DBMSJDATAPUWP . SET_PARALLEL (handle , 5 ) ; 
1 929 DBMS _D ATA PUMP . START_JOB (handle) ; 
1 931 DBMS^DATA PUMP .DETACH (handle ) ; 
END; 

1921 



Fig. 19 
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BEGIN 

2003 handle : = DBMS JDATAPUMP . OPEN ( * IMPORT' , *FULL' , NULL, 

' OTDBMQVB_ItiP' > ; 



2005 DBMS JDATAPUMP . £ETJ?ARAMETER ( handle , * KBEPJ4ASTER ' , 0 ) ; 
/^~DBMS_DATAPUMP . ADD_FILE (Handle , 1 filel.dmp' , 

% MY^NEWDIRl ' , 1 60GM' ) ; 
DBMS JDATAPUMP . ADD_F1LE (handle , * 1 1 le2 . dmp' , 

*MY_NEWDIR2' , % S00M' ) ? 
2007 DBMS JDATAPUMP , ADD_FILE (handle , % f Ile3 .dmp' , 

*MYJ*£WDIRV , *600M' ) ; 
DBMS JDATAPUMP . ADD FILE (handle , 4 f ile4 .dmp' , 

*MYJWEWDIR4' , s C00M' } ; 
v — D8MS_QATAPUMP , ADD_FI LE (handle, *U1»S ,<3mp' , 

* MY NEWDIR5' , *600M' ) ? 

2009 DBMS JDATAPUMP METADATA JiENfAP (handle, * MAPJTABLE SPACE ' , 

'OSER1' , *NEWU£ER1* ) ; 
2011 DBMS JDATAPUMP. SET^PJUUIJLBL (handle, 4> ; 
201 3 DBMS JDATAPUMP . START_JOB < hand le) ; 
201 5 DBMS JDATAPUMP . DETACH (handle) ; 
END; 

2001 



Fig. 20 
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Table 1 : APIs and Job states 



API 


Valid 
Job stales 
for AIM 


Description 


ADD.FILE 2103 


Defining 

Executing 3 

idling 3 


Specifies a file for the dump file set, or the 
location of the log tile or the location of 
the file to receive the SQLJ-'ILE output. 


ATTACH 2105 


Defining 

Executing 

Idling 

supporting 

Slopped 

Completing 

Completed 


Al lows a user session to monitor a job 


DVTAJUTER 2107 


Defining 


Restricts data processed by a job S 


DETACH 2109 


Defining 
Executing 
idling 
Step peix&^g 
Completing 


Disconnects;! user session from a job 


TTTT 

GET_STATUS 


Obtains the status of a job 


LCXi_ENTRY 2113 


Acids an entry to the log file 


M ETA D ATA_F I ITER 21 


5 Defining 


Restricts metadata processed by a job 


M ET. \ D. \T \JR EM A P 21 


7 Defining 


Remaps metadata processed by a job 


ft^TADATAJTRANSFORM 


Defining 


Alters metadata processed by a job 


2121 

OPEN 


Undefined 


Creates a new job 


512T" 

SET.PARAl.UEU 


Defining 
Executing 
Id ling 
SkppetKlitijj 


Specifies parallelism for a job 


SETJ'ARAMETER 2125 


Defining 

v.jF ^ * mill w 


f VlteiN default nroce>sinu bv a ioh 


START JOB 212 ' 


Defining 
Idling 


Begins/resumes executing a job 


212S 

STOPJOB 

I 


Defining 

Executing 

Idling 

| Stop pendiri 


Initiates orderly shutdown of a job \ 

■ i 



a. Export jobs only 



Fig. 21 
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Data Pump 
clients 2203 



r 



"1 



2207 



2209 



2211 





Other Clients: 

OEM, Unload 
Repl, Apps 



The DataPump 



DBMS_DATAPUMP 

Data/metadata movement engine 



2203 











Oracle^ 
Stream 

Read/Write 

2217 




External Table API 


2213 



Direct Path API 



2219 



X 



Metadata API 



2221 



311 



2201 



Fig. 22 
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Cliert 



2301(a) 



Status, log, 
error queue 
2305 



Clienl B 




2301(b) 



2303(a) 



Client A's 
shadow 
process 



Dump File Set 323<a...d) 
Master table copy 325, data & metadata 
^ i ± * ' 



2309 



Copy 
325 



2307 



□□□ □□□ 



' Master ^ 
Control 
Process 


V 


J 




r 2311 


Get 
Status 



( Client B's 
shadow 
process 



2303(b) 



Dynamic commands 
(throttle, abort, et< i.) 
2313 



Exp/lmp 
Worker H 
Process A 



< — ► 



Exp/lmp 
Worker 
Process B 



/ 

/ 



/ Exp/lmp 
Worker 
Process C 




Exp/lmp 
Worker 
Process D 

2317(a...d) 

Command, 

control, 
error queue 
2315 




Parallel 
Execution 
Process 



2319(a) 



Parallel ^ 
Execution 
Process 



2319(b) 



Fig. 23 
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OPEN fileless 
import job: 
Specify a link to a 
remote DBMS and 

create a master 
table in the DBMS 
performing the job 
with initial non- 
object rows 



I 



2403 



Further define job: 
add rows to the 
master table that 
specify filters and/ 
or transforms that 
are to be applied 
to the objects, 
and parameters 
for the job. 



2405 



START_JOB: 
Begin execution of 
the job as defined 

in the master 
table. 



2409 



defining 
stage 
611 



2421 



Get metadata for 
an object from the 
source DBMS by 
object type 
according to a 
predetermined 
order of types 



2411 




2413 




write the object's 
row to the master 
table. 



Fileless IMPORT 2401 



I 



2415 



2423 



Use metadata for 
the table data 
object's table to 
fetch the table 
data object from 
the source DBMS . 



Use the metadata 
contained in the 
object to create 
object(s) in the 

destination DBMS 



2419 



2425 



write the object's 
row to the master 
table. 



2427 



i 



Insert the object 
into the table data 
object's table in 
the destination 
DBMS. 



Fig. 24 



